tone_synth object

This method generates a given note or list of notes that will last for a specified number of beats, with the additional option of being able to bend.

bool note_bend(string notes, double bend_amount, double length, double bend_start, double bend_length)

Parameters:
notes
A string specifying a note or list of notes to generate.
bend_amount
The amount in semitones to bend the pitch.
length
The length of the generated notes, in beats.
bend_start
The beat at which to start the bend.
bend_length
The length of the bend, in beats.

Return value:
true on success, false on failure.

Remarks:
Notes are written inside a string and are separated by a comma and space. Values inside notes are case sensitive.

Notes are written as the note letter from A to G (notice that they are upper case), followed by the octave number. To sharpen a note add a # after the note and before the number, and to flatten it use a b (lower case). Middle C is C4. Valid notes are from C0 to D#8/Eb8.

The notes provided in the list will be generated together (as opposed to separately, one after the other), allowing for easier and quicker creation of chords.

When specifying bend_amount, positive values bend upwards while negative values bend downwards.

The length is specified in beats, based on the value of the tempo property.

Example:
// Write a B major chord and bend it up to an E major.

tone_synth synth;

void main()
{
synth.note_bend("B3, D#4, Gb4", 5, 4, 1, 1);
synth.write_wave_file("wave.wav");
}